package com.hr.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
//开启swagger2
@EnableSwagger2
public class SwaggerConfig {

    /**
     * 文档接口信息 对象，将其注入到ioc容器中
     * @return
     */
    @Bean
    public Docket docket(){
        //api文档信息 构建器
        ApiInfoBuilder apiInfoBuilder = new ApiInfoBuilder();
        // 设置文档标题、描述、版本、联系人
        apiInfoBuilder.title("OA系统接口说明文档")
                .description("文档描述")
                .version("v 1.0.0")
                .contact(new Contact("张三", "www.baidu.com","zhangsan@qq.com"));
        //构建出 api 文档信息对象
        ApiInfo apiInfo = apiInfoBuilder.build();

        // 指定文档风格
        Docket docket = new Docket(DocumentationType.SWAGGER_2)
                // 指定生成的文档中的封面信息；文档标题、版本、作者
                .apiInfo(apiInfo)
                //选择生成哪个包下的api文档
                .select()
                //指定controller包，swagger会自动生成此包下的接口文档
                .apis(RequestHandlerSelectors.basePackage("com.hr.controller"))
                //此controller任意路径都要生成api文档
                .paths(PathSelectors.any())
                .build();
        return docket;
    }

}